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protocol) Protocol for TENEX <-> Line Processor Interactions 

Introduction 

This document is a detailed description ot the Line Processor 
protocol. It is intended to serve as a guide to anyone wisning to 
implement tne Line Processor protocol, as well as, a Piece ot 
documentation for tne Line Processor. 

It snould be pointed out here tnat the Line Processor contains a 
very small, slow microcomputer with little read/*rite memory. For 
this reason the protocol is terse and error reports and/or 
recovery almost non-existant . Ihe Line Processor terminal is 
treated more as a hardware device than an intelligent terminal. 

There are two types of line processors - alpha and graphic. Alpha 
line processors are used in configurations consisting of the line 
processor alpha/numeric display, mouse, keyset, and possibly a 
hard copy printer or a cassette drive. Graphics line processors 
are used in the the minimum graphics configuration consisting ot 
a/n display, mouse, Keyset, ana either a Tektronix 4012 or 4U14 
storage tube display. 

Conventions 

Coordinates 

Alpha 

Coordinates designate character positions. For example 
(1,1) is the second character on the second line up from tne 
bottom. 

The origin is at the lower left corner ot the screen. 

As components of the protocol, coordinates are passed as one 
oyte of X and one of Y ana always wawe 40b aadeu to tnem to 
get tnem in the printing character range. Ihis limits the 
max coordinate value to 137B which is 9b decimal, 

Graphics 

The mouse is used to track the cursor on either the a/n 
display or the storage tube. A switch acts as a toggle to 
select which screen is to be tracked. Coordinate values are 
identical to the alpha line processor when they originate 
from the a/n display, although they are sent as two bytes 
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each of x and y. Graphics coordinates from the storage tube 
are sent as 10 bit values in the range 1024 to 2047, *ith 
1024 at the lower left of the screen. 



TTx Simulation 

in IT* simulation, scrolling always takes place on a line teed 
(LF) not a carriage return (CR). Carriage return does the 
obvious thing and no more. 

Special and Control Characters 

Protocol strings begin with 33B ana are followed with an 
operation type character in the range 40b to 120b. 

When outside a protocol string, all control characters (0 thru 
37B) are ignored by the Line Processor, except: 

When the cursor is being tracked: 

"G which rings a bell if possible 

CR and LF which do the right thing 

Notice that backspace character (*H) is not implemented in 
I'll simulation (i.e. when the cursor is being tracked). 

when the cursor has been positioned: 

"G which rings a bell if possible 

~H which does a backspace cursor 

When inside a protocol string, RUBUUT is NU'i ignored. When 
outside, it is ignored. 

Conventions for this document 

In this document, octal numbers are followed oy "B". 

"Unescorted" means that characters are sent as is without 
wrapping them in an protocol sequence. 

Line Processor to Main Computer Protocol 

Communication in this direction will adhear generally to the iMLAC 
protocol as outlined in ( 1JUURNAL , 14345 ,) . 
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in particuiar: 

Keyboard characters 40B thru 177B are unescorted. 

Keyboard characters thru 37B are sent as: 

34B, 43B, char*140B, coordinates 

NUTt:: An alternate (and preferred) way is to send tnese 
control characters as is (unescorted) except tor 2b, 4b and 
30B. ihose are sent as above. 

Mouse button changes are send as: 

346, 43B, buttons* 100b, coordinates 

where buttons is the binary image ot button positons (000 
thru 111 binary). 

Keyset strokes 1 thru 32B are send as: 

stroketl40B (e.g. l -> a) 
keyset strokes 33B thru 37B are sent as: 

33B -> 54B (,) 

34B -> 56B (.) 

35B -> 73B (; ) 

36B -> 77B (?) 

37B -> 40B (space) 

For alpha line processors coordinates are X ♦ 40b, y + 40b. 

For graphics line processors coordinates are X(bits 10 - b 
(MSB'S)) ♦ 40B, X(Dits S - (LSB')) ♦ 40B, YCbitS 10 - b) + 
40B, ¥(bits 5 - 0). 

When not in coordinate mode the mouse buttons are ignored and 
keyboard control characters (0 thru 37B) are sent in unescortea 
fashion. 

At power-up and after the "system-reset" button is pushed, the 
Line Processor signals the Main computer by sending: 
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( 17bB, 177B ) 

The purpose ot this is to indicate to the applications program 
that the Line procesor is no* in a "power-up" state (see 
below) . 

, When the Line processor detects an error that it cannot live with, 
it sends a string to the applications prorgam and dies with an 
error code flashing in the lights. The user is then forced to nit 
"system-reset", ihe string is as follows: 

( 176B, 4lB, Ccount', Chars) 

where Ccount' is 40B more than the number of characters that 
follow. Currently b characters are sent, and the string 
Iooks like: 

C 176B, 41B, SOB, err', ctl', trk', rpf, s*', obuf, bl', b2' 
) 

where the ' indicates that 40B has been added. 

err: The error code, one of 

10B = output butter to display overun Cimpropper 
padding) . 

lib = some other butter overun (e.g. printer butter) 

12B = strange error relating to display output butter. 

13B s protocol sequence error (e.g. bad comand) 

14B = protocol value error Ce.g. bad coordinate). 

ctl: control state parameter 10 = not in a command) 

trK: mouse tracking cooe: 

= positioned 

1 = tracking 

2 = cursor in small TTY windo* 
5: cursor at unknown position 
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12B s Cursor in full screen window 

rpt: repeat code, normally zero 

sw: sense switch immage in order 0-1-2-3 (sw3=LSB) 

obuf: display output buffer character count 

bi: possibly low order 4 bits of last input Char 

b2: possibly high order 4 bits of last input char 

From Main Computer to the Line Processor 

The following functions are sent by the applications program and 
performed by the Line Processor. All cooes, except the escape 
CiiB) should be printing characters. Padding characters should be 
RUBOUTs (177B). The baud rate factor (t) and and aispiay type are 
obtained oy the applications program by sending an interogate 
command. 

Note: 

The cursor is generally used to track the mouse. Some 
commands stop the tracking and allow the cursor to be used 
for display manipulation. "Tracking mode" refers to *nether 
the mouse is being tracked by the cursor or not. 

Display-terminal dependent parameters: 

The following table yields the timing and other factors 
required by the protocol that depend on the type of terminal 
connected to the Line Procesor. Ihat type, DItype, is 
obtained from tne interrogate command (see belo*). 



param 




Ditype= 








1 


2 


3 


4 


Del 


60 


7 


1 


17 


Ins 





7 


30 


17 


Clr 


5 


6 


3 


17 


Xmark 


NO 


xes 


xes 


Yes 
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Del is the time to delete a line. 

Ins is the time taken to insert a new line. 

Clr is the time taken to clear the screen. 

Xmark indicates it a marked character needs to be re-written 
after the mark is removed. 

See the interrogate response command tor other display 
parameters. 

Position cursor on alpha display and stop tracking mouse. 

Send(33B, 40b, X', Y') 

X' = X coord CO thru Xmax) 4 40b 

Y' = Y coord (0 thru Ymax) + 40b 

result: 

Positions cursor to specified location. Tracking stops 
until a "resume tracking" or a reset is received. Any 
unescorted characters will be written on the screen and 
the cursor will be advanced once alter each character. 
Writing beyond the end of the line is not advised as the 
result depends on the terminal manufacturer ana model. 

Specify (small) TTY simulation window on alpha display 

SendC 33B, 416, top, bottom) 

top = x* tor top line of window 

bottom = Y' tor bottom line of window 

result: 

invokes a small TTY simulation window of specified size 
and location. This window will be used until a new one is 
specified or a reset is_re_cel_vea. This does not change 
the tracking mode^ 

Reset 

SendC 33B, 51b ) 
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result: 

screen cleared 

TTx simulation window set to tull screen 

bug selection stack reset 

resume tracking isee) 
padding: 

send pads as for clear screen. 

Resume tracking mouse 

Seno( 33B, 42B J 

result: 

The cursor is used to track the mouse. Any unescorted 
characters will go into the iTx simulation window 
currently in use. 

Write string of blanks 

Send( 33b, 43b, h* ) 

N' s number of blanks to be written. 

result: 

The specified number of blanks are written starting at 
the current cursor position. The cursor is left at the 
character position following the last blank. Assumes the 
cursor has been positioned appropriately beforehand. 

This command is a no-op if N* is not >= 41B And <= 177B. 

£ padding: 

This command must have N/f padding characters following 
it. 

Push bug selection 

SendC 33B, 46B, X', Y' J 
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result: 



The coordinates are pushed on a stack ana the character 
at that location is somehow brought to the user's 
attention. The stack will hold a maximum ot b selections. 
This commana includes a resume tracking. 



padding: 



ft> 



(Q 



This command must have 8/f padding characters following 
it. 

Pop bug selection 

Send( 33b, 47b ) 

result : 

The top entry on the bug selection stack is Popped. The 
corresponding character on the screen is no longer marked 
in a special way. it the stack is empty, this command is 
a no-op. This command includes a resume tracking 
operation. 

For some Ultypes, the applications program must restore 
the character or the marked position will be replaced by 
a space. 

padding: 

This command must have 8/f padding characters following 
it. 

Delete selected line 

Send( 33B, 446 ) 

result; 

The cursor position selects a line to be removed from the 
screen. All following lines are moved up one line. The 
contents of the last line are unaetineo. The x 
coordinate should be zero, otherwise the results are 
unaetined. 

padding: 
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This command requires Del/f padding characters (Del is 
obtained trom the table). 

Insert selected line 

SendC 33B, 45B ) 

result: 

The line which the cursor is on, and all following lines, 
are moved do*n one line. The cursor is not moved, and 
nence is on a blank line. Lines above the cursor are not 
altered. Ihe last line (before the execution of this 
command) should oe considered "lost," Ihe X coorainate 
snould De zero, otherwise the results are undefined. 

padding: 

This command requires lns/f padding characters (Ins is 
obtained trom the table). 

Clear screen „ 

Send( 33B, 50B ) 

result: 

The entire screen is cleared. The cursor position is not 
generally known, lne TTY. simulation *indow location and 
the bug selection stack are not altered. The tracking 
mode is not changed. 

padding: 

Tnis command requires Clr/t pad characters; 

Interrogate line processor 

Send( 33B, 5SB ) 

result: 

A response to the interrogate command is sent as a 
protocol string of this form: 

34B, 4bB, Xmax*40b, ¥max+40B, LPtype, Dtim pate s 
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where 

Xmax is the maximum x coordinate 
xmax is the maximum y coordinate 
LPtype is in [40B-177BJ and designates type 
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The least significant tour bits ot Lptype 
designate dispiay terminal type leal] it Ditype) 
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Currently detined are: 

(1 ) Delta Data &200 

(2) Hazeltine H2000 

(3) Data Media Elite 2S00 S ^' ^( o' :■' : * L-><^ 

(4) Lear Siegler ADM-2 

The most significant three bits desiqnate Line 
Processor type (call it Type) 

Currently detined are: 

(0) Complete alpha line processor with 
copy printer receiver tor cassette drive 

(2) Line Processor with Mouse, Keyset, 
Printer 

(6) Graphics line processor with lektronix 
4014 

(7) Graphics line processor with Tektronix 
4012 

Dtim is a characteristic delay time. For proper 
scrolling, a line teed (Lb) must be followed by 
(Dtim+i4)/f pad characters. 

Hate indicates the Line Processor receive baud 
rate: 

300 buad: 100B, f = 32 decimal 



<J 



11 



D1A lb MAP 77 xxxxx 
MCS4 Information 



600 baud: 60b, f = 16 

1200 baud: bOB, t = 8 

2400 baud: 446, t=4 

4800 baud: 42B, f = 2 

9t>00 baud: 41B, f = l 

The baud rate factor, f . Rate-40B; 

Note: Any additions to LPtype should be assigned by 
AhC personel tor best results. See D1A oi Chi 
@SHi-ARC. 
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This command does not change the tracking mode. 

Turn off coordinate mode «. 

SendC 33B,* bOB ) 

result : 

Turns off the coordinate mode in the Line Processor. This 
does not change the tracking moae. 

^Mouse buttons become inactive, ke_yj^at0_contr_ol i 
characters- sent -to,.main computer without protocol 
forjn^.tlDg. 

Turn on coordinate mode 
Sendl 33B, 61B ) 
result: 

Turns on trie coordinate mode in the Line Processor. This 
does not change the tracking mode. 

Mouse buttons become active, keyboard control characters 
are sent in input protocol format. 



j)lj) Begin standout mode 
SendC J3B, bob ) 
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result: 



All following text written on tne screen will be altered 
is some way from "normal" text. This unfortunately 



*hich go into tne Tit simulation 
t leave the line processor in this 
Does not change tne tracking moae. 
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includes characters 
window also, so don 
state indefinitely. 

End standout mode 

SendC 33b, 57b ) 

result: 

Subsequent text written on the screen will be in "normal" 
mode. Does not change the trackinq mode. 

TENEX RESTARTING 

The Line Processor will detect a ItNEx restart, by looking 
tor the ten 33b's it sends out at startup time. At that 
time it will place itself in a state as though the hardware 
reset button had been pushed. 

Open printer (alpha line processor only) 

SendC 33B, 53B ) 

Result: 

Opens the printer tor output. Protocol to the printer 
must be observed: (1) open it. (2) wait tor protocol 
string M request M (below). (3) sena strings in response to 
requests. (4) close it. 

"Request" string, sent back to the main computer: 

OB NOLL 

Each request enables the application program to 
send an additional lb characters via the printer 
string protocol below. 

Note: The count indicates the Line Processor storage 
allocated for tne next printer string. Sendina a longer 
string will result in a "receive error" (error light on 
panel) . 
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Close printer (alpha line processor only) 

Send! 33B, 54B ) 

Result: 

Closes the printer. Actual close will not take place 
until all characters in the output outfer are printed. 
That Is, the close may follow trie last string of 
cnaracters immediately. It is possible (but very 
unlikely) that a "request" protocol string may be sent to 
trie main computer alter trie close is sent to the Line 
Processor . 

Printer string (alpha line processor only) 

Send( 33B, 526, Dev, Count+406, <characters> ) 

Result: 

The Dev' is normally 40B and is ignored by Line Processors 
with one printer. The Count must not be greater than the 
sum of tne counts in all "request" protocol string not 
already fulfilled. It may be less. ihe actual character 
string may contain any characters. They will r>e sent to 
the printer without translation or special handling. 

Note: 
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Strings may be sent to the printer without opening it it 
timing constraints are observed carefully, in this case 
the applications program must know the baud rate ot the 
printing device a well as the Line Processor - Mam 
computer line. The program just issues printer strings 
and no requests are sent back to trie Main computer oy tne 
Line processor. Ihis *as a delibeiate implementation to 
allow higher speed printing over networks witnout waiting 
for tne response. Observe that if strings are sent too 
fast the printer outfer in the Line Processor will 
overflow: data will be lost and the Line Processor will 
die. Tne printer butter normally holds 47 characters.. 

Open graphics display (graphics line processor only) 

Send( 33B, 53B ) 

Result: 
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Disables mouse trackinq on the grapnics display. 
Close graphics display (graphics line processor only) 
Send( 33B, 54b ) 
Result: 

blnsaoles mouse tracking on the graphics display, 
write graphics display (graphics line processor only) 
Send( 33B, 52B, Dev, Count+40B, Characters) ) 

Result: 

The Dev is normally 40B and is ignored by Line 
Processors. Characters irom the application program are 
written directly on the graphics display. Since the 
characters are not buttereo, the graphics dis Pl ay must be 
connected at a higher baud rate tnan the external 
processor . 

Set graphics cursor resolution (graphics line processor only) 
Send( 33B, b2B, N* ) 

Result: 

N controls the mask applied to the cursor coordinates 
betore they are used to position the cursor on the 
grapnics display: 

N = o Mask = 
= 1 



= 2 
= i 
= 4 
= 5 
Application notes: 



= l LSb is cleared (etc) 
= 3 

s 7 
= 17B 
= 37B 
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Avoid writing text Cor "string of blanks") beyond the end of a 
line: tne display may insert an unwanted line or drop tne extra 
characters. 

Avoid positioning tne cursor to any x>Xmax or y>¥max. 

Avoid aoing an insert line on the last line: tne display may 
scroll the entire screen. 

Delta Data (Ditype=l) must be treated as a special case in the 
following respect: 

When writing text at (x,y) on a line which does not already 
have text on it up to position x (e.g. after a clear screen 
or insert line), the applications program must send x/t pad 
characters after the first character written at position 
lx,y). The display takes that long to move a CH symbol into 
the proper display memory location. (Our thanks to Delta 
Data) . 



we expect to stop supporting Delta Datas soon. 



NOTE: 
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The Line Processor has a reset button on it (wnich will oe used 
only on rare occations). After power up or a hardware reset, 
the following state prevails: 

The screen is clear, the mouse tracking in operation. 

The bug selection stack is empty. 

The full screen 1T¥ simulation is in effect. 

Coordinate mode is NOT in effect. 

Printer is closed 

All 1TY simulation windows currently work as follows: Text is 
inserted in tne last line and "scrolling" occurs on each line 
feed (i.e. it does not start on the top line of the window ds 
you may prefer). A CH moves tne cursor to left marqin, a LF 
effects a line break. Typing beyond the last character of the 
line causes a line "wrap" - i.e. new text replaces the old 
line, starting from the left margin. Tne only v*ay to cleaT a 
small TTx' window is to send N line feeds into it, where H is 
the number of lines in the window. 
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The usual sequence trom the applications program win be to 
position tne cursor and perform some function, or write text, 
or both. It must end such a sequence with a "resume tracKing" 
command. Any broadcast messages, links, etc, that come down 
the line between the cursor position and the "resume tracking" 
will go wherever the cursor happens to be. 

Normally, broadcast messages and the like will go into the 
lit simulation window. The difference being that they are 
not preceedeo by a position cursor command. 

REENTER code in NLS will clear and repaint the entire screen 

Mouse tracking will be done by the Line Processor under the 
following conditions: 

l¥ the terminal has received a "resume tracking" command 
since the last position cursor command, AND 

IF there is no input trom the TEN, AMD 

> - ■ ■ 

the mouse coords have changed since the last mouse tracking 
operation, or the cursor has been moved since the last mouse 
tracking operation. 

Tracking stops unaer the following conditions: 
A position cursor command comes from the TEN. 
Summaries 

Line processor to Exernal processor 



CHAR SEQUENCE 



MEANING 



(all line processors) 
CHARACTER 



Normal Character 



(Ascii values IB to 177B except (String request), 2 (~B), 
4 CD), J4b (BCESC), and l7bb (Reset)) 



BCESC 46 MX M¥ TP DT BD 



Interrogate Response 



17 
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176 177 

176 41 CCNT CCHBS 



System Reset 
Error report 



(alpna line processors) 

BCESC 43 CC X x 
Chars 

BCESC 43 CC X i 
*X (CD) 

BCESC 43 Mb X i 

(NULL) 



Optional Sequence For control 

Sequence For *U (CA), -b (CDOT), 

Sequence For Mouse buttons 
String request 



%J 



(graphics line processors) 

BCESC 45 CC XI X2 xl X2 
Cnar s 

BCESC 4b CC XI X2 Yl X2 
"X CCU) 



Optional Sequence For control 
Sequence For *D (CA), -B (CDOI), 
Sequence For Mouse Buttons 



BCESC 4b MB XI X2 Yl Y2 
Where: 

Ail numbers are in octal 

CCNX = number of CCHHS + 40 

CCHRS = CCNT-40 data bytes; each byte is offset by 40 

CC = control character + 140 

MB = current moJse button state ♦ 100 

X = current x corrdinate ♦ 40 

X = current y corrdinate * 40 

XI = top 6 significant bits of x coordinate + 40 
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X2 = least significant 6 bits of x coordinate ♦ 40 
Yi = top 6 significant bits of y coordinate ♦ 40 
12 = least significant 6 bits ot y coordinate t 40 
MX = maximum x coordinate + 40 
MY = maximum y coordinate ♦ 40 
TP = line processor type and version * 40 
DT = terminal delay time cnaracter istic ♦ 40 
BD = line processor receive baud rate ♦ 40 
Exernal processor to Line processor 



COMMAND 



CODE 



PADDING 



^ 



position 

XTY window 

resume tracking 

write blanks 

aelete line 

insert line 

pusn bug 

pop bug 

clear screen 

reset 

printer string 

open printer port 



3313 , 40B, X*, Y' 

33B, 41B, Y TOP', Y BOTTOM' 

336, 42B 

33B/ 43b, N' 

33B, 44B 

33B, 45B 

33B, 4bB, X*, Y' 

33B, 47B 

33B, 50b 

33B, 51B 

33B, 52B, DEV, CNT', String 

336, 53b 



none 

none 

none 

N/F 

DEL/f 

1NS/F 

8/F 

8/F 

CLH/F 

CLH/F 

see text 

see text 
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33B, 62b, N* 
10 - 33B's 



none 
none 
none 
none 
none 
none 
none 
none 



close printer port 33b, 54B 
interrogate 33B, 55B 

standout mode on 33b, bbb 
standout mode ott 33b, 57b 
coordinate mode ott 33b, 60B 
coordinate mode on 33B, 61B 
cursor resoiution 
remote resart 
(mcs4) MCS-4 Assembler in TREE META 
FILE msc4 CHECK 
META file 

ERKUh: -> '; sst ;endU*; 

SIZE: S=1000 M=100 K = S0 N=1000 L=10 G = 10; 
^J DUMMX: ado mt lh neg; 

FIELDS: UP=[4:8J 0PA=14:4J UP8=18:4J T*PE=14:18) P=L4:8J 

AD1= 14 :8 J AD2=t4:4J AD3=14:0J AD8=[8:OJ; 
A'lTKlBurEs: reg pair; 
% declarations parsing % 

tile = ("FILE" / -> "FILE" ) .ID <"-MCS-4 ASSMBLER 12/1 l/73"> 
< M -FILE "*1> £S defned ^DISCARD 
l>*mcs4J 

Sdeclare sst :endU*; 
end => 

>-mcsend SSYMSC ?3 delned ♦$ / < M undetined symbol: M ♦$ > ) 
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